home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / maxidi22.lzh / MAXIDISK.DOC < prev    next >
Text File  |  1992-06-05  |  18KB  |  343 lines
  1. NB: File name:    MAXIDISK.DOC        Revised:    1992.06.05
  2. NB: Created by:    Ulf Ronald Andersson    Created:    1992.02.07
  3. NB:
  4. NB: File purpose: to document the release of 'Revised MaxiDisk 2.2'
  5. NB:
  6. NB: Copyright:    Original released as PD FREEWARE by author:  Max Böhm  1987.
  7. NB: Revisions released as PD FREEWARE by author: Ulf Ronald Andersson  1992.
  8. NB:        
  9. NB:
  10. NB:    This is not the original documentation, which seems lost to mankind.
  11. NB:    At least I have not yet found any complete archive for this utility.
  12. NB:    So I have had to take the liberty of creating this DOC file,
  13. NB:    since I have made some long-needed revisions to MaxiDisk.
  14. NB:    As follows:
  15. NB:
  16. NB:    Revision 2.0 updates of February 1992:
  17. NB:
  18. NB:    1. I have implemented the XBRA protocol for all 3 vectors used.
  19. NB:       This was one of the two reasons I made this revision.
  20. NB:
  21. NB:    2. I have modified the memory protection method, so that MaxiDisk
  22. NB:       now is compatible with OVERSCAN.PRG and other programs that
  23. NB:       previously could crash MaxiDisk (especially when nearly full).
  24. NB:       (OVERSCAN.PRG must be started after MaxiDisk to function well)
  25. NB:       The need to use it with OverScan etc., was of course my other
  26. NB:       main reason to make this revision (by now practically rewrite).
  27. NB:
  28. NB:    3. I have patched the BPB handling to ensure better efficiency
  29. NB:       when using huge ramdisks, which old MaxiDisk hardly packed.
  30. NB:       BPB is still non_standard, of course, in that it has as many
  31. NB:       logical clusters as there are physical sectors, but that is
  32. NB:       how packing was made transparent to the OS.
  33. NB:
  34. NB:    4. I have completely rewritten the data block allocation code.
  35. NB:       The original seemed to be compiler-generated rubbish.
  36. NB:
  37. NB:    5. I have completely rewritten the pack/unpack routines, and have
  38. NB:       changed the packing algorithm a bit. This makes packing a bit
  39. NB:       tighter and faster, although no packing ramdisk can be FAST.
  40. NB:       At present the new MaxiDisk seems to run at one eigth the speed
  41. NB:       of QWIKDISK, as measured by QINDEX, which will do for me.
  42. NB:
  43. NB:    6. I have eliminated a lot of compiler-generated garbage-code, and
  44. NB:       unneeded huge file arrays (that have NEVER been used !!!).
  45. NB:       Also the insane program startup sequence, which turned the data
  46. NB:       and BSS sections upside-down.  (Really...!)
  47. NB:
  48. NB:    7. I have also patched and streamlined each and every routine that
  49. NB:       remains in the program to get rid of that silly compiler stuff.
  50. NB:       eg:    "LEA    (A0),A0"  and such-like ridiculous nonsense.
  51. NB:
  52. NB:    For more technical details, read the file MAXITECH.DOC .
  53. NB:
  54. NB:
  55. NB:    Revision 2.1 updates of March 1992:
  56. NB:
  57. NB:    Several routines were trimmed for higher efficiency, and one byte
  58. NB:    in the simulated 'boot' sector was adjusted.
  59. NB:
  60. NB:
  61. NB:    Revision 2.2 updates of May 1992:
  62. NB:
  63. NB:    1. The routine that searches for the MPB pointers of TOS has been
  64. NB:       improved, and now functions on all known TOS versions.
  65. NB:
  66. NB:    2. Some sector handling routines have been improved, though this
  67. NB:       may be masked by the delays caused by packing.
  68. NB:
  69. NB:    3. MaxiDisk 2.2 has been tested error-free on several TOS versions
  70. NB:       ranging from TOS 1.0 through TOS 1.4 to KAOS 1.4.2.
  71. NB:       Since no TOS-dependent features are used it should always work.
  72. NB:       Unfortunately the present release of TOS 2.6 has a bug in the
  73. NB:       code for 'warm' reset, such that no reset-proof ramdisk seems
  74. NB:       to be possible under this TOS !!!  (I will investigate this)
  75. NB:
  76. NB:
  77. NB:    I will surely improve the program even further, but at present I
  78. NB:    think I have achieved what I set out to do.  Which was to revive
  79. NB:    this great idea of a packing ramdisk, in a version acceptable by
  80. NB:    modern standards and compatible with other modern programs.
  81. NB:
  82. NB:    The remainder of this file is the best near-original DOC's I have.
  83. NB:    Where I have discovered errors in it, or made important revisions,
  84. NB:    I have inserted notes like the one immediately below.
  85. NB:URA:  This line shows how my notes will appear below.
  86. ---------------------- Here follows older text -------------------------------
  87.  
  88. Cologne , West Germany , July 4 , 1988
  89.  
  90. ---- This file is a translation of the original German README file, written 
  91.      by Max Böhm, the author of this exceptional public domain program.  
  92.      Translated by COLONIUS.  Comments made by the translator are within 
  93.      brackets.
  94.  
  95. MAXIDISK.PRG installs a resetproof ramdisk, which compresses the files 
  96. stored in it.  It is usually possible, to store about 750 kB in a 500 kB 
  97. ramdisk!  This version works with all versions of ROM based TOS, including 
  98. the new Blitter TOS of the MEGA STs.  Any memory size, up to 4 megabyte, is 
  99. supported.  (Although it makes little sense to use a ramdisk on a 512 kB 
  100. system.)
  101.  
  102. MAXIDISK.PRG should reside in the AUTO folder on your boot disk, although 
  103. you may also install the ramdisk from the desktop after booting your ST.  
  104. (In this case you should rename the program to MAXIDISK.TOS, since it is not 
  105. a GEM application and will cause trouble if started as one.  It must, 
  106. however, carry the .PRG extender to autoboot from the AUTO folder.)
  107.  
  108. The first thing MAXIDISK.PRG does, is to check if there is already a 
  109. MAXIDISK installed.  In this case, you are informed about the size and the 
  110. assigned partition name and the installation terminates.
  111.  
  112. After this, MAXIDISK checks for MAXIDISK.INF on drive A and B (if started 
  113. from floppy) or on the logical drive (partition) it was started from.
  114. {Paul Varn note:  If MAXIDISK.INF is not found, you are requested to enter
  115. a size and partition letter.}
  116.  
  117.  If you would rather abort the installation of the ramdisk after starting
  118. MAXIDISK.PRG, simply hit return without entering a numeric value when 
  119. prompted to enter the desired ramdisk size.  A message will inform you
  120. that the ramdisk was not installed.
  121.  
  122. Once the MAXIDISK is installed, it is resetproof.  This means that the 
  123. contents of the ramdisk will survive the reset, not the driver program 
  124. itself.  You must start MAXIDISK.PRG after a reset, to be able to access the 
  125. data in the ramdisk.  If you fail to do so, the ramdisk will still remain 
  126. intact over any number of "warm" resets, but it will seem to be empty (0 
  127. bytes in 0 files) until the MAXIDISK driver is reinstalled.
  128. {Paul Varn note:  Actually, you must use a re-named version of Maxidisk
  129. called: MAXIDISK.TOS.  When you do this, the screen will just blink and
  130. return to the desktop.  A symptom of a re-set fault is that when you access the 
  131. drive, the bytes are ZERO with NO FILES SHOWN.  Don't worry.  After running 
  132. MAXIDISK.TTP, everything will return to normal.  However, it IS possible to 
  133. get such a severe system crash, that Maxidisk won't servive.  This has been 
  134. rare for me.  If you re-boot from the same disk or drive that Maxidisk was 
  135. started from, it will take care of itself and all will be normal without the 
  136. need to re-run Maxidisk.}
  137.  
  138. MAXIDISK.INF is an ASCII file which you may use to install the maxidisk 
  139. automatically after MAXIDISK.PRG has been invoked.
  140.  
  141. MAXIDISK.INF contains the size of the ramdisk, the drive letter which shall 
  142. be assigned to the ramdisk (C through P) and the names of programs that 
  143. should be started after the ramdisk has been installed.  (You may edit this 
  144. file with any text editor or word processor that allows you to save plain 
  145. ASCII files.  If you should use 1st Word (any version), be sure to switch off 
  146. the word processor mode.  You may also delete MAXIDISK.INF entirely, if you 
  147. prefer to enter size and drive number manually.)  The example MAXIDISK.INF 
  148. file installs a 500 kB ramdisk as drive D, copies the contents of the folder 
  149. COPY_IT to the ramdisk and finally starts SET_TIME.TOS.  (see also COPY.TTP 
  150. and SET_TIME.TOS)
  151. {Paul Varn note:  Unfortunately, the person who uploaded to version of this 
  152. ARC that I found, corrupted the .INF file so that the suggested use of the 
  153. auto-run feature was not shown.  I've tried several ways to do this and have 
  154. not found it.  I prefere to use HEADST by CODEHEAD anyway.}
  155.  
  156. NB:URA:  Better instr